SPACE 1

home *** CD-ROM | disk | FTP | other *** search

/ SPACE 1 / SPACE - Library 1 - Volume 1.iso / telecomm / 309 / qt / qt.doc next >

Wrap

Text File | 1985-11-19 | 12KB | 320 lines

QT(1) QT(1) USAGE qt [no][conn|image] [verbose|terse] [cfg=s] [timeout=n] [dial=c] [prefix=s] [suffix=s] [escape=c] ABSTRACT Qt is a modem program for the Atari ST series of microcomputers. It can transfer files via xmodem or kermit, it has a builtin phonebook with autodial capacity, it allows definition of keyboard macros, and it allows reading and writing of configuration files. DESCRIPTION Qt is moded; that is, you are either talking to the modem or talking to Qt. Qt takes single-character commands ('.' prefixes some extended commands) to do a variety of things; COMMAND WHAT IT DOES. b= Show the current baudrate. (Qt supports 300,1200, and 2400 baud.) b1 Set the modem to 1200 baud. b2 Set the modem to 2400 baud. b3 Set the modem to 300 baud. b? Print a help message for the b commands. c Connects to the modem. You get back into command mode by typing the modem escape key (the default escape key is the undo key, but you may change it -- see .s for details.) d List a disk directory. When you type 'd', Qt finishes the word 'dir' and waits for you to type in the directory name. If you just type a return, Qt lists the working directory. Each listing show the permissions on the file, how many Kbytes the file takes up, and the filename. The permissions are set up in a list 'dwsh', with a dash meaning that that permission is denied. PERMISSION WHAT IT MEANS. d File is a directory or volume label. w File is writable. s File is a system file. h File is a hidden file. h Hang up the phone. When you type h, Qt echos (thud) and drops carrier for a second. If this doesn't hang up the phone, repeating it two or three times should do the trick. QT(1) QT(1) m Show current macros and their values. Macros are used only in connect mode. When you type a key that you mapped to something else, the string you mapped it to is sent to the host computer. (See the explanation of .m for more info) o Show current settings of user-settable variables (See the explanation of .s for more info) If you are connected to a host computer, Qt will tell you here. p= List the phonebook. Qt maintains a phonebook of up to 26 numbers, which you can call by typing 'px', where x is a lowercase letter. The listing of the phonebook is formatted <letter> => <number>:<comment>. Letter is the letter you type to call that number, <number> is the string that is sent to the modem (any ascii character except a colon), and <comment> is anything that comes after the first colon on the line. (See the description of .p for how to add numbers to the phonebook.) pa-z Call phone # a-z. When you dial a number, Qt will automatically add a prefix and suffix to the number it sends to the modem. (So, if you are using a Hayes(tm) modem, Qt sends ATD<number><return> to it.) If you want to abort a phone call (before the connection has been established), just press any key -- the phonecall will be cancelled and you will return to the 'qt>' prompt. If you have a comment for this phone number, Qt will display 'calling <comment>' while dialing. p; Call a number not in the phonebook. When you type this, Qt will prompt you for the phone number, which it will then dial just like a stored phone number. p! Redial the last number. p? Display a help message for the p command. q Quit. Qt completes the word 'quit' and returns you to the calling program (the Desktop.) QT(1) QT(1) xr Get a file using the Xmodem protocol. Qt will prompt you for the name of the file, then for a start character to send to the modem. (so, for example, if you are getting a file from a Citadel BBS, you escape to command mode when it asks you whether you are ready to accept the file -- after doing the xr and entering a filename, using 'y' for the start char will start up the transfer.) On systems that do not wait for a start character, the spacebar is a harmless character to type. Qt defaults to image (8 bit ascii) transfers, but you may specify a 7 bit ascii transfer by entering 'xtr'. (You may force binary transfer by typing 'xbr' as well.) xs Send a file using the Xmodem protocol. The details of xs are exactly the same as xr, except you are sending the file. x? Print a help message for xmodem commands. ! Do a system command or a shell escape. When you type '!', Qt will wait for you to enter a line to execute (Just return will call up an inter- active shell.) To use !, you must have the program command.prg in the root directory on the current drive or have a shell name specified by the environment variable SHELL. .b Print out a version/author banner. .m Define a macro. When you enter '.m', Qt will prompt '.map: ' and wait for you to enter a C/R terminated string. If this string is of the form 'x=yyy', Qt will assign the macro 'yyy' to the key 'x'. (If the string is not of that form, Qt will give you a nasty message.) You may enter special characters (except ^C -- if you enter ^C, Qt will crash!) via '\N', where N is 1 or more hexadecimal digits. (So the string \04=spam\0d assigns the macro spam<C/R> to ^D.) Also, \n maps to ^J, \r maps to <C/R>, and \t maps to <TAB>. .p Add or delete a phone number from the phonebook. When you enter '.p', Qt will prompt '.phone:' and waits for you to enter a C/R terminated string. To delete a phone # from the phonebook, enter a string of the form '-x', where 'x' is the menu selection for the phone number you want to zap. Any other string is added to the phonebook. (See the description of 'p' for the form of a legal phone number.) QT(1) QT(1) .r Read in a new configuration. When you enter '.r', Qt prompts '.read cfg? ' and waits for you to enter a C/R terminated filename. If Qt can read this filename, it will add the configuration information in that file to your current configuration. (See the section on initialization for the format of a configuration file.) .s Set a Qt option. When you enter '.s', Qt prompts '.set: ' and waits for you to enter a C/R terminated string. This string may be of the form 'opt=val', 'opt', or 'noopt'. 'opt=val' sets the option to 'str', 'opt' sets the option to TRUE, and 'noopt' sets the option to FALSE. Option What it does [no]image Set the default mode for file transfers. If you specify 'noimage', files will be transferred with the high-bit stripped. if you specify 'image', file transfers are 8-bit. The default is 'image' verbose Qt will print more and longer messages. (This is the default) terse Qt will remain as silent as it can. timeout=NN Set the file transfer timeout in seconds. If you are transferring a file and the host computer doesn't reply in that time, Qt will attempt to restart the transfer (or abort if repeated tries fail.) The default is 'timeout=30' prefix=str Prefix phone numbers with this string when you dial a number. (Qt uses 'ATD' for its default prefix string.) suffix=str Append this string to phone numbers when you dial a number. (Qt uses a single C/R for its default suffix string.) escape=char The key you type to return to command mode from connect mode. (Qt uses <undo> for its default escape character.) QT(1) QT(1) The options below are only used when you first invoke Qt. You may put them into your qt.rc file or specify them on the command line. [no]conn If you specify 'conn', Qt will drop into connect mode when you invoke it. If you specify 'noconn'(the default), Qt will drop into command mode when you invoke it. cfg=name Instead of reading configuration data from the file 'qt.rc', Qt will read the file 'name.' See the section on initialization for more detail on how a configuration file is set up. dial=x Dial phone number 'x' when Qt finishes initialization. .w Write the current configuration to a file. When you enter '.w', Qt will prompt '.write cfg?' and wait for you to enter a C/R terminated filename. Qt then writes out the configuration. .? Print out a help message for the '.' commands. INITIALIZATION When you enter Qt, it attempts to set up your configuration from the arguments you give it on the command line and the contents of your qt.rc file, if any. The arguments on the command line follow the format of the .s command (opt=val, opt, noopt...) and are described under the description of the .s command. After dealing with the arguments on the command line, Qt will read more configuration from the file 'qt.rc' (or the filename you gave it in cfg=name on the command line.) A Qt configuration file is a ordinary textfile with different commands on each line. Each command is of the format (cmd) (argument): command what it does set Set a Qt option. The argument for this command is of the form opt=val, opt, or noopt (the options are described under the .s command.) map Define a macro. The argument for this command is of the form 'x=yyy' (just like the .m command -- look there for details.) dial Set up a phone number. The argument for this command is the same as the argument for the .p command. QT(1) QT(1) In addition, lines beginning with '#', and blank lines are ignored. Here is a sample Qt configuration file: # this is a comment line set noimage set dial=a map \01=password\r map \04=other password\r dial 123-4567:BBS #1 dial 123-7654:BBS #2 This file configures Qt for ascii text transfers (7-bit), maps ^A to 'password<C/R>', ^D to 'other password<C/R>', puts the phone number for BBS #1 and BBS #2 into your phonebook, then dials BBS #1. MISCELLANEOUS There are 2 main prompts for Qt. If you are not connected to a host computer, Qt will prompt for commands with 'Qt>'. If you are connected to a host, Qt prompts with '*Qt>'. (All Qt commands are available with either prompt.) BUGS The documentation is a wee bit verbose, but it 'probably' doesn't tell the novice everything s/he wants to know. AUTHOR Orc (David Parsons)